home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 27 / CU Amiga Magazine's Super CD-ROM 27 (1998)(EMAP Images)(GB)[!][issue 1998-10].iso / CUCD / Programming / THXPlayLib / thxplay_lib.readme next >
Encoding:
Text File  |  1998-06-16  |  1.6 KB  |  48 lines
  1. Short: Library to play THX and THX2 modules
  2. Author: Dexter/Abyss, Kyzer/CSG
  3. Uploader: Kyzer/CSG <kyzer@4u.net>
  4. Type: dev/misc
  5. Replaces: dev/e/PlayTHX.lha
  6.  
  7. NOTE: This archive is for developers, if you just want the library
  8. and a player, get mus/play/PlayTHX.lha instead.
  9.  
  10.  
  11. This is a lovely interface to the replayer binary of THX2.
  12. - use generic 68000 version or 68020 optimised version.
  13. - use either shared library, C linklibrary, or E module.
  14. - comes with full autodocs and development materials.
  15.  
  16. Changes since previous release:
  17. - fixed internal documentation.
  18. - C pragma/protos/linklibrary etc.
  19. - now uses different conditionals in the source.
  20. - shared lib now checks for 020 processor.
  21. - patched some player bugs (yes, Dexter has already been informed)
  22. - removed the 3rd result of thxPlaytime(), as it annoys C users.
  23. - seperated from PlayTHX archive.
  24.  
  25. Functions in the interface:
  26.   thxInit -- initialise player and module.
  27.   thxFree -- free resources held by player.
  28.  
  29.   thxPlay -- start playing the song.
  30.   thxPause -- pause play of a song.
  31.   thxStop -- stop playing a song/module.
  32.   thxWind -- wind the song forward or back.
  33.  
  34.   thxGetNumSongs -- get number of subsongs.
  35.   thxSetSong -- set song to be played.
  36.  
  37.   thxGetVolume -- get master volume.
  38.   thxSetVolume -- set master volume.
  39.  
  40.   thxPlayNote -- start playing a user-specified note.
  41.   thxStopNote -- stop playing user-specified note.
  42.   thxNoteFX -- perform FX command on user-specified note.
  43.  
  44.   thxSyncByte -- get sync byte value.
  45.   thxSignalEnd -- Signal() when song ends.
  46.   thxSongEnded -- detect if song has ended.
  47.   thxPlaytime -- get current playtime of song.
  48.